================================================================================
============================

			GeneralTouch AcousticWave Touchscreen USB interface
                      README file for touchscreen software for XFree86[tm]&Xorg[tm]


			        	Version 3.1beta
			  Copyright 2001-2006 General Touch Co. Ltd.

================================================================================
============================

Thank you for choosing our USB,AcousticWave Touchscreen products!! This README
 file contains
additional notes about our touchscreen software which,we think,will help you
 make better use of
our touchscreen and touchscreen software.

Author: Roy.Yin<yhch@generaltouch.com>.2006

NOTE: The Quick start method uses pre-built files.The calibration tool and
 driver were built and tested on a Linux 2.6.11 kernel and Xorg 6.8 They
 have downward compatibility.

===========
CONTENTS
===========
1.QuickStart Guide for touch screen driver and calibration utility
2.Valid entries for each of the lines in the subsection
3.Software Component
4.Problem solution

==================================================================
1.QuickStart Guide for touch screen driver and calibration utility
==================================================================

1) The controller needs to be attached to a USB port .

2)Install with setup utility
   Login as root ,run setup with "./setup_u" 

That's All! 

3)Install manually
   If there is a problem during installing with setup utility,you can install manually:
   I.Open a terminal,enter the folder of setup_usb,and run"chmod +x uninstall_u;./uninstall_u" first!
   II.Get the device interface
     Open a terminal,enter the folder of setup_usb,and run"chmod +x gevinit;./gevinit"
     you will get:"gusbcal /dev/input/eventX"
     And the "/dev/input/eventX"(X for [0,1,2....]) is our device interface
  III.The driver "gentouchusb_drv.o" 
      Open a terminal,enter the folder of setup_usb,
     A: If the folder "/usr/lib/xorg/modules/input/" is existed,run "cp gentouchusb_drv.o /usr/lib/xorg/modules/input/"
     B:If the folder "/usr/lib/xorg/modules/input/" is not existed, the folder "/usr/X11R6/lib/modules/input/" is existed,run "cp gentouchusb_drv.o /usr/X11R6/lib/modules/input/"      
  IV.modify the configure file of XFree/Xorg
      Open your configure file:
      For example:In Redhat 9,the configure file is "/etc/X11/XF86Config"
                         In  Fedora Core,the configure file is "/etc/X11/xorg.conf"
      Find the section "ServerLayout" add the following  line to this section:
	For example :
       Section "ServerLayout"
			Identifier     "Default Layout"
			Screen      0  "Screen0" 0 0
			InputDevice    "Mouse0" "CorePointer"
			InputDevice    "Keyboard0" "CoreKeyboard"
			Inputdevice    "touchscreen_usb" "SendCoreEvents"
		EndSection
     Create a new section at the tail of the configure file,and replace the device interface("/dev/input/eventX") with what your get at step II:
     For example :
     Section "Inputdevice"
		Identifier "touchscreen_usb"
		Driver "gentouchusb"
		Option "Device" "/dev/input/eventX"
	EndSection
  V:Restart your X window with "Ctl+Alt+Backspace"
  VI.calibrate
    Open a terminal,enter the folder of setup_usb,
	change the mode of these files:
    "chmod +x genuctl gtconfiger guxcal reporter"
     calibrate:
     "./genuctl off;./guxcal /dev/input/eventX ;./genuctl  on;"
  VII:uninstall manually
       Delete the contents that come from III to VI
  VII:If the touchscreen does not  work still,run "./reporter",and send the file "/tmp/reporter.tgz" to us
2.Software Component
=======================
Our Touchscreen Software package is composed of the following programs:

	gentouchusb_drv.o             Our Touchscreen driver for XFree86&Xorg.

	calibrate_u                   Our touchscreen calibration program.
	
	genpanel_u			Our control panel 

	readme.txt                 It's me!


=====================
3.Problem solution
=====================
1)Permission denied:
  Login to the system console as root and do it again.
2)Can't exit to a text console:
  If your system is running in graphics mode,you must exit to a text console
 prompt first.If your system is set up to automatically start the X window
 system at boot time an provide a praphical login screen,you will need to shut
 down the window system display manager.On many Linux systems,this can be
 accomplished by running the command: 
   #init 3
   If this does not work,you will need to locate and kill the display manager
 process,which is usually one of:xdm,gdm,kdm,or prefdm.
3)To verify that the touchscreen is connected correctly to the PC and that it
 is functioning correctly, type the following command in an X terminal window: 

	sudo gevint

Then you can get message like thie "guxcal /dev/input/event0"
4)Not the above
You can just run reporter and email the reporter.tgz which gathered by reporter to us,then we can
 find the problem for you.
NOTES:
   With any notion,advice,demands,
   Contact us.

================================================================================
==============================

                                   General Touch Co. Ltd.
				
  				 http://www.GeneralTouch.com

                                   All rights reserved.

================================================================================
==============================
      

